Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRReplaceCursor

You can use the QTVRReplaceCursor function to replace any of the standard QuickTime VR cursors with your own custom cursors.

OSErr QTVRReplaceCursor (QTVRInstanceqtvr, CursorRecord *cursRecord);
qtvr
An instance of a QuickTime VR movie.
cursRecord
A pointer to a cursor record. See "Cursor Record" for a description of the cursor record.
function result
A result code.

DESCRIPTION

The QTVRReplaceCursor function replaces one or more of the standard QuickTime VR cursors associated with the instance specified by the qtvr parameter with the cursors specified in the cursor record pointed to by the cursRecord parameter. If the type field of the specified cursor record is kQTVRUseDefaultCursor , the default cursor for the given resource ID is reloaded; in this case, the handle field of that record should be set to nil .

QTVRReplaceCursor replaces the standard cursors only for the specified QuickTime VR movie instance. To replace the standard cursors for all QuickTime VR movie instances you create, you need to call QTVRReplaceCursor for each such instance.

QuickTime VR makes a copy of the cursor handle spcified in the cursor record. The application is responsible for disposing of its own cursor handle.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |